一、MinGW + Qt Creator（Windows）

重要： SDK 与编译器的 ABI 必须匹配。MinGW 编译的库与 MSVC 编译的库不能混用。下载 SDK 时请选择 MinGW 版本。

1.1 创建项目

打开 Qt Creator，创建一个 Qt Widgets Application，命名为 qt_demo。

1.2 导入 SDK

在项目根目录下新建 libs 文件夹，将 SDK 文件拷贝进去：

项目根目录/
├── libs/
│   ├── include/
│   │   ├── c_interface/
│   │   ├── cpp_interface/
│   │   └── parameter/
│   ├── libnrc_host.dll.a    # MinGW 导入库
│   └── nrc_host.dll         # 运行时动态库
├── main.cpp
├── mainwindow.h
├── mainwindow.cpp
├── mainwindow.ui
└── qt_demo.pro

在 qt_demo.pro 末尾添加 SDK 引用：

# 1. 指定头文件路径
INCLUDEPATH += $$PWD/libs/include
# 2. 指定库文件搜索路径
LIBS += -L$$PWD/libs
# 3. 链接库文件（注意名称格式）
LIBS += -lnrc_host
# 4. 生成后自动复制 DLL 到输出目录
win32 {
    DLL_SOURCE = $$shell_path($${PWD}\\libs\\nrc_host.dll)
    DLL_TARGET = $$shell_path($${OUT_PWD}\\\\)
    QMAKE_POST_LINK += $$quote(cmd /c copy /Y $$quote($$DLL_SOURCE) $$quote($$DLL_TARGET))
}

1.3 编写最小连接代码

在 mainwindow.cpp 中添加头文件和连接测试：

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include "cpp_interface/nrc_api.h"   // SDK 头文件
#include <QDebug>
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 1. 连接控制器
    SOCKETFD fd = connect_robot("192.168.1.15", "6001");
    if (fd <= 0) {
        ui->statusBar->showMessage("连接失败，请检查 IP 和端口");
        return;
    }

    // 2. 等待连接就绪
    while (get_connection_status(fd) != 0) {
        QApplication::processEvents();
    }
    ui->statusBar->showMessage("连接成功！fd=" + QString::number(fd));
    qDebug() << "SDK 版本:" << QString::fromStdString(get_library_version());
}
MainWindow::~MainWindow()
{
    delete ui;
}

1.4 编译运行

选择 MinGW 编译套件，点击运行。如果状态栏显示"连接成功"，说明 SDK 配置正确。

验证标准： 不是"头文件能引入"，而是实际连接控制器成功。如果编译报链接错误，请检查 LIBS 路径和库文件名是否匹配。

下一步

完成连接测试后，请浏览接口示例了解更多 API 用法。